home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PROGRAM / ZTIMER11.ARJ / NOTES < prev    next >
Text File  |  1992-04-20  |  2KB  |  58 lines
  1.  
  2.                         The Zen Timer Library
  3.                         =====================
  4.  
  5.                             Version 1.1
  6.  
  7. Turbo Pascal Notes
  8. ------------------
  9.  
  10.    Duncan Murdoch kindly took the time to build a Turbo Pascal interface
  11. for the Zen Timer library, which requires Turbo Pascal 6.0 or above (so
  12. he tells me :-). Following are his notes on the interface unit.
  13.  
  14.    The interface to the assembler routines is written to be as simple as
  15. possible.  Void functions became procedures; the count functions returning
  16. unsigned long integers return signed longints.  Leading underscores were added
  17. to the procedure/function names to match the assembler source.
  18.  
  19.    Because of limitations in the linker, TP versions prior to 6.0 will
  20. *not* be able to use this unit.
  21.  
  22. Interfaced routines:
  23.  
  24. procedure _PZTimerOn;              Starts precision timer.
  25.  
  26. procedure _PZTimerOff;             Stops precision timer.
  27.  
  28. procedure _PZTimerReport;          Reports result of precision timing to
  29.                                    standard output.
  30.  
  31. function  _PZTimerCount : longint; Returns microsecond count for precision
  32.                                    timer.  May overflow, and return negative
  33.                                    value.  Value -1 signals timer overflow.
  34.  
  35. procedure _LZTimerOn;              The LZ routines are as above, but for
  36. procedure _LZTimerOff;             the long period timer.
  37. procedure _LZTimerReport;
  38. function  _LZTimerCount : longint;
  39.  
  40.    I have asked Duncan if it is possible for Turbo Pascal to handle 
  41. unsigned long integers, since times greater than about 35 minutes will 
  42. become negative when interpreted as a signed long integer. If this is not
  43. possible, then you will have to take this into account when using the
  44. library.
  45.  
  46.    Please note that as in this version the Turbo Pascal related code does
  47. not include the ultra long period timing routines and does not have the
  48. advantage of the C++ class interface (naturally :-) as I don't have
  49. Turbo Pascal and have not ported the changes.
  50.  
  51. You can contact me with comments, queries and bug fixes as shown below:
  52.  
  53. Internet:
  54.  
  55. Kendall Bennett                                 kjb@godzilla.cgl.citri.edu.au
  56. Duncan Murdoch (Turbo Pascal unit)              dmurdoch@watstat.uwaterloo.ca
  57.  
  58.